home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / bbs / u342q07.lha / u_msgadd.lha / msgadd.doc < prev   
Text File  |  1993-08-09  |  2KB  |  45 lines
  1. MSGADD
  2.  
  3.    MSGADD is utility for use with programs which act as gateways
  4. between Citadel-compatible systems and other (foreign) networks.  Its
  5. purpose is to allow the addition of messages to a Citadel-86 message
  6. base.  The 'typical' system operator will rarely have a use for this
  7. utility.
  8.  
  9.    The command line format of MSGADD is
  10.  
  11.       C>MSGADD <node name> <file names>
  12.  
  13.    The first argument, node name, should be the name of a node on
  14. your nodelist, typically (although not always) a node which has been
  15. designated OtherNet.  The purpose of specifying a node name is to allow
  16. correct routing address decisions to be made by MSGADD, which will in
  17. turn allow Citadel to route messages from the foreign network to
  18. other Citadel systems.
  19.  
  20.    There should be at least one file name following the node name.  Each
  21. file should contain at least one message from the foreign network in
  22. C86Net message format (see NETHACK3.MAN for the complete specification).
  23. Of all the fields that makes up a C86Net message, the following should
  24. be filled in by the gateway program for each message:
  25.  
  26.         Author
  27.         Date
  28.         Name of Origin System - need not be 'node name' in the command line
  29.         Node ID of Origin System - a matter for some thought
  30.         Room for message - a MUST
  31.         Recipient if and only if msg is private mail
  32.         Message Text
  33.  
  34.    Attempting to add messages to rooms which are not shared with 'node
  35. name' will result in warning messages, but the messages will be
  36. inserted.  By formally sharing rooms with 'node name' you ensure that
  37. the companion utility to MSGADD, MSGOUT, will pick up messages for the
  38. foreign net properly.  See MSGOUT.DOC.
  39.  
  40.    There is one weakness in MSGADD: it does not do vortex processing on
  41. the messages from the foreign network.  This is simply the result of a
  42. lazy programmer.  However, when dealing with virtual rooms, the MSGOUT
  43. utility should always be run before the MSGADD utility due to the way
  44. Citadel-86 remembers which messages still need to be sent to other nodes.
  45.